home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / dev / gui / triton11.lha / Triton / ReadMe < prev    next >
Text File  |  1994-07-14  |  12KB  |  282 lines
  1.  
  2.                 **********************************************
  3.  
  4.                     triton.library
  5.  
  6.                     The object oriented GUI creation system.
  7.  
  8.                     Release 1.1
  9.  
  10.                     (c) 1993-1994 Stefan Zeiger
  11.  
  12.                 **********************************************
  13.  
  14.  
  15.     Be  sure  to  read  the  file 'Distribution', too!  It contains important
  16. information about registering Triton and using Triton for your own products!
  17.  
  18.     If you have suggestions or remarks about Triton, or if you find any bugs,
  19. please let me know.
  20.  
  21.     Contacting the author:
  22.  
  23.         EMail:      stefan@wwsp.adsp.sub.org
  24.  
  25.         Z-Netz:     stefan@sweet.zer.sub.org
  26.                     stefan@plus.zer
  27.  
  28.         FidoNet:    Stefan Zeiger 2:244/6302.15
  29.  
  30.         Mail:       Stefan Zeiger
  31.                     Seligenstädter Weg 24
  32.                     D-63796 Kahl
  33.                     Germany
  34.  
  35.         Voice:      +49-6188-2525 (after 6:00 PM GMT/UT only!)
  36.  
  37.     Please use EMail/Z-Netz/FidoNet if possible.  This is more convenient for
  38. me and your chance of getting a reply quickly is much better.
  39.  
  40.     There  have  been  some problems lately with EMail delivery from Internet
  41. sites  to ADSP sites.  If an EMail to wwsp.adsp.sub.org bounces, please try a
  42. FidoNet  gateway  (Stefan.Zeiger@p15.f6302.n244.z2.fidonet.org)  or my Z-Netz
  43. address (stefan@sweet.zer.sub.org).
  44.  
  45.     Note  that  even  when  you are able to reach me that way, I might not be
  46. able  to  reply  to your mail.  I know that a lot of people are still waiting
  47. for  answers  to their mail about Triton.  As soon as I've got a working mail
  48. link again, I'll try to reply.
  49.  
  50.  
  51. Contents
  52. ========
  53.  
  54. 1. Introduction
  55.  
  56. 2. Installation
  57.  
  58. 3. Using triton.library
  59.  
  60. 4. Astronomy Lesson
  61.  
  62. 5. Library history
  63.  
  64. 6. Credits
  65.  
  66.  
  67. 1. Introduction
  68. ===============
  69.  
  70.     triton.library is a standard Amiga shared, runtime library.  Triton makes
  71. it  much  easier to create good-looking graphical user interfaces (GUIs) than
  72. GadTools, BOOPSI or other systems.
  73.  
  74.     The most important features are:
  75.  
  76.     - Object oriented system
  77.     - Automatically font sensitive, font adaptive
  78.     - Automatic keyboard shortcuts for default window actions
  79.     - *Really* easy to use
  80.     - Beautiful customizable OS2.x/3.x look
  81.     - Comes as a freely distributable shared library
  82.     - Size! Though Triton is very powerful, it is a shared library of less
  83.       than 50KB. You don't need any startup tools, BOOPSI classes or other
  84.       things. It's the Triton among the minnows of GUI creation systems ;)
  85.     - Resizeability of windows wherever applicable
  86.     - A Preferences editor which allows you to customize the look and feel
  87.       of all Triton GUIs
  88.  
  89.     By   using   Triton   you  don't  have  to  worry  about  otherwise  very
  90. time-consuming   things  like  font-sensitivity  and  resizeability  of  your
  91. windows.  What is even more important is that you can easily change your user
  92. interfaces  later without having to rearrange display objects.  Simply add an
  93. object to a group and the whole GUI will adapt to make room for it.
  94.  
  95.     The  usage  of a Triton GUI should be pretty clear.  All windows have two
  96. additional   keyboard   shortcuts   (if   not   explicitly  disabled  by  the
  97. application):   'Esc'  will simulate the 'close window' gadget and 'Del' will
  98. simulate  the  'resize  window'  gadget.   In  palette,  slider, scroller and
  99. similar  gadgets with an up/down facility you can use the shifted shortcut to
  100. decrease the value.
  101.  
  102.  
  103. 2. Installation
  104. ===============
  105.  
  106.     First  of  all, Triton requires at least OS2.04.  If you're still running
  107. 1.2 or 1.3, you have to upgrade to OS2.04 or better.
  108.  
  109.     To  install  triton.library  copy it to your Libs:  directory by hand, or
  110. run  the  installation script which corresponds to your system (OS2.0, OS2.1+
  111. with different languages) by double-clicking its icon.
  112.  
  113.     Two  versions  of  triton.library are included in this distribution.  The
  114. one  in libs37 requires OS2.04 or better, the one in libs39 requires OS3.0 or
  115. better  and  is  optimized  for  OS3.0+,  so  that it is shorter and will run
  116. slightly  faster  than  the  OS2.04  version on an OS3.0+ system.  The OS3.0+
  117. version cannot be used with OS2.0/2.1.
  118.  
  119.  
  120. 3. Using triton.library
  121. =======================
  122.  
  123.     If  you  are  a  C  programmer  all you need to do is include the correct
  124. header  ('libraries/triton.h')  and  open triton.library.  After that you can
  125. use  the  functions  in  the  library  as  if they were C functions.  If your
  126. program  quits  it  must of course close the library again.  You may also use
  127. the  support functions in the Triton linker library which make it even easier
  128. to use Triton.  See 'demo.c' for an example.
  129.  
  130.     The FD (function description) file is included for the case that you want
  131. to  write glue code for other compilers/languages.  If you do so, please send
  132. it to me for inclusion in the next Triton distribution.
  133.  
  134.     Functions  allowing  a variable number of arguments can't be called using
  135. pragmas  (in-line library calls; no glue code required).  So if you use these
  136. you  must  always  link  with LIB:triton.lib (for SAS/C, or with the specific
  137. libraries  for  your compiler/language).  All library functions are explained
  138. in the autodoc file 'triton.doc'.
  139.  
  140.                                                 Live long and prosper!
  141.  
  142.  
  143. 4. Astronomy Lesson
  144. ===================
  145.  
  146.                         Triton - A moon of Neptune
  147.  
  148.     Triton  is  a quaint little moon, in that it is one of the very few moons
  149. to  be  known to have retrograd orbits around their host.  Triton is believed
  150. to  be a 3-6000 km large world of mostly liquid nitrogen oceans, perhaps with
  151. a  thin  methane atmosphere as well, but noone knows for sure since either of
  152. the Voyager twins ever got close enough to take convincing snapshots.
  153.  
  154.     Neptune  itself  is also quite strange in that it has an almost 90 degree
  155. tilted  inclination,  so  that it "rolls" through space, unlike Earth and the
  156. other planets (minus Venus), which all spin like tops in their orbits.  Noone
  157. can  tell  for sure why Neptune has such an excentric inclination, but it has
  158. been  suggested  that  it  was  caused  by  a gigantic collision of some sort
  159. (probably with a large asteroid).  In the process Neptune also lost its third
  160. moon,   which  at  the  time  was  none  other  than  Pluto.   The  collision
  161. accellerated  Pluto  to  the  point  where it had enough momentum to actually
  162. leave  its  orbit  and shoot into space on its own.  As it did so it probably
  163. passed  below  the Roche' radius of Neptune, causing it to break up in two or
  164. more bodies under the influence of the massive tidal forces of Neptune.  This
  165. would certainly account for Charon, which is in itself too large to have been
  166. "captured" by an object as small as Pluto.
  167.  
  168. Okay, end of today's astronomy lesson :-)
  169.  
  170.  
  171. 5. Library History
  172. ==================
  173.  
  174. *****************************************************************************
  175. RELEASE 1.0 (Library version 1.138)
  176.  
  177.     First release.
  178.  
  179. *****************************************************************************
  180. RELEASE 1.1 (Library version 2.54)
  181.  
  182.     Preferences editor added.
  183.     Image class added.
  184.     The Triton C support code is now compatible with SAS/C, DICE and gcc.
  185.     Linker libraries for gcc added.
  186.     AmigaOberon support added.
  187.     Minimum AmigaE and Assembler support added.
  188.     Triton is now localized for OS2.1+. German and swedish catalogs are
  189.       included.
  190.     The shared library triton.library is now single-based. You may use it
  191.       from within other libraries and resident code and even patch
  192.       triton.library functions with SetFunction(). Other benefits include
  193.       smaller code size, less run-time memory requirements and faster
  194.       startup of triton.library.
  195.     Screen locking functions added.
  196.     Bug fixed: Added TR_Message.trm_App to avoid dereferencing already freed
  197.       TR_Message.trm_Project fields in order to get the TR_App of a message.
  198.     Bug fixed: Now TREZ_Return also works for ID 0.
  199.     Bug fixed: class_Scroller and class_Slider objects had problems with
  200.       filled backgrounds.
  201.     Now all class_Listview objects report double clicks.
  202.     It is now possible to put independant lines/columns into arrays. These
  203.       lines/columns will not be aligned like all other array elements. This
  204.       is especially useful for separator bars in arrays. See Triton demo
  205.       (window 'Groups') for an example.
  206.     TRCY_MX added. Cycle gadgets may now as an alternative be displayed as
  207.       mutually exclusive gadgets.
  208.     Object backfill inheriting added.
  209.     Named class_FrameBox objects added.
  210.     Texts created with class_Text may now be right-aligned.
  211.     It is now possible to avoid ugly gaps below listview objects. Instead
  212.       the gap will move to the end of the vertical group in which the
  213.       listview gadget is embedded. The listview creation macros in the C
  214.       includes for Triton have been changed to behave that way as default.
  215.     Bug fixed: class_Listview had problems with backfill patterns under
  216.       OS versions < 39 (OS3.0).
  217.     Bug fixed: In OS versions < 39 setting a new list in a listview caused
  218.       GadTools not to select any item of the list even though it was a
  219.       ListSS gadget which should *always* have a selected item. Now the
  220.       last selected item of the old list becomes selected in the new list
  221.       when you change the list entries (as in OS3.0+).
  222.     Bug fixed: All texts in TR_EasyRequest() now have TRTX_NOUNDERSCORE set.
  223.     Help support added.
  224.     Obsolete TR_AddClass() prototype removed.
  225.     Bug fixed: Changing the string in a string gadget didn't work.
  226.     Enhancement: When the TRAT_Disabled flag of an object is reset to its
  227.       current state, no refresh will be done.
  228.     Bug fixed: After attaching a list to an empty ListSS gadget, there was
  229.       no selected entry. In this case the last selected entry will now
  230.       become selected again after attaching a new list.
  231.     Bug fixed: TR_EasyRequest() mis-aligned gadgets in requesters with more
  232.       than one gadget.
  233.     TR_OpenTriton() allows to set the screen title.
  234.     Both window and screen title can be modified after opening the window.
  235.     Bug fixed: Pressing down a button and then disabling it caused the
  236.       disabled button to stay pressed down.
  237.     Bug fixed: Text in selected gadgets is now using the correct color.
  238.     Bug fixed: Objects in framing boxes were not disposed correctly.
  239.     Some new Triton demos added.
  240.  
  241. *****************************************************************************
  242.  
  243.  
  244. 6. Credits
  245. ==========
  246.  
  247. Thanks must go to:
  248.  
  249.     - Nico François for his suggestions, beta-testing and helping me with
  250.       some very weird problems in Triton
  251.  
  252.     - Carsten Raufuß for beta-testing, suggestions and nagging ('When will
  253.       you finally implement listviews? I do really need them for my GUI!' ;)
  254.  
  255.     - Kai Iske for his BOOPSI class sources
  256.  
  257.     - Michael Berg for the 'Astronomy Lesson' and beta-testing
  258.  
  259.     - Gunther Nikl for the gcc support
  260.  
  261.     - Magnus Holmgren for the swedish translation and DICE support
  262.  
  263.     - Klaus Melchior for the DICE support
  264.  
  265.     - Peter Fröhlich for the AmigaOberon support
  266.  
  267.     - All the unmentioned guys on SPOT.BETA for beta-testing and suggestions
  268.  
  269.     - Philipp Lonke, Marco Frischkorn and Patrick Ohly for beta-testing
  270.  
  271.     - Danny Schrod and Chris Reichert (SysOps of 'Plus' and 'Publishers
  272.       Treff') for support
  273.  
  274.     - SAS Institute for their great C compiler. With SAS/C it was
  275.       possible to develop Triton without a single line of assembly.
  276.  
  277.     - Commodore for the Amiga
  278.  
  279.                   __
  280.                __///
  281.                \\\/...if(2B|!2B) user->prefs.shakespeare=TRUE;
  282.